<?php
namespace app\api\interfaces;
/**
 * @name 统计分析
 * @sort 3
 */

interface AnalysisInterface {

    /**
     * @name 同步<span style="color:red">用户分析</span>数据
     * @sort 1
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:begin_date,v:2018-01-01,t:开始时间
     * @post k:end_date,v:2018-08-07,t:结束时间
     * @case {"code":200,"flag":true,"msg":"已更新粉丝数据","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     * @remark <p style='color:red'>0、请注意：不传递begin_date与end_date时间：统计当前月的数据<p/><p style='color:red'>1、最多一次性获取7天的数据</p><p>2、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据。</p><p>3、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。</p><p>4、为确保公众号数据已完成统计和处理，请于每天上午8点后查询公众号前一天的数据</p>
     */

    public function actionSync_user();
    /**
     * @name 同步<span style="color:red">图文分析</span>数据
     * @sort 2
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:begin_date,v:2018-01-01,t:开始时间
     * @post k:end_date,v:2018-08-07,t:结束时间
     * @remark <p style='color:red'>0、请注意：不传递begin_date与end_date时间：统计当前月的数据<p/><p style='color:red'>1、最多一次性获取7天的数据</p><p>2、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据。</p><p>3、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。</p><p>4、为确保公众号数据已完成统计和处理，请于每天上午8点后查询公众号前一天的数据</p>
     */

    public function actionSync_article();

    /**
     * @name 同步<span style="color:red">消息分析</span>数据
     * @sort 3
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:begin_date,v:2018-01-01,t:开始时间
     * @post k:end_date,v:2018-08-07,t:结束时间
     * @remark <p style='color:red'>0、请注意：不传递begin_date与end_date时间：统计当前月的数据<p/><p style='color:red'>1、最多一次性获取7天的数据</p><p>2、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据。</p><p>3、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。</p><p>4、为确保公众号数据已完成统计和处理，请于每天上午8点后查询公众号前一天的数据</p>
     */

    public function actionSync_msg();


    /**
     * @name <span style="color:red">粉丝统计图</span>数据
     * @sort 5
     * @date 2018-08-01
     * @post k:appid,v:wxxxxxxxxxx,t:授权公总号appid,n:
     * @post k:type,v:new_user,t:数据统计类型（new_user：新增的用户数量、cancel_user：取消关注的用户数量、clean_user：净增用户数量、cumulate_user：总用户量）,n:
     * @post k:timer,v:yesterday,t:时间区间(yesterday：最近一天、nearly_a_week：最近7天、nearly_a_month：最近30天)
     * @post k:begin_date,v:2018-02-10,t:开始时间
     * @post k:end_time,v:2018-05-06,t:结束时间
     * @post k:user_source,v:,t:用户来源（不传递此参数默认全部）
     * @case {"wx_account_id#微信公众号id": "1cef072dbccb4f67c3bdf9b3627d8a0b","accountappid#公众号appid": "wxxxxxxxxxxxxx","type#类型":"new_user","type_remark#类型说明":"新增用户数","list#统计列表":[{"num#数量":"1","date#日期":"2018-02-1"},{"":""}],"total":{"new_user#新增的用户数量": "12","cancel_user#取消关注的用户数量": "11","clean_user#净增用户数量": "1","cumulate_user#总用户量": "965", "percent#增长率": {"new_user#新增的用户数量": {"yesterday#日": 0,"week#周": 1,"month#月": 0},"cancel_user#取消关注的用户数量": {"yesterday": 0,"week": 0.33,"month": 0},"clean_user#净增用户数量": {"yesterday": 0,"week": 0,"month": 0},"cumulate_user#总用户量": {"yesterday": 0,"week": 0,"month": 0}}}}
     * @remark 其中：传递timer时，begin_date与end_time 可以不传递，传递时间区间begin_date 与end_date 不传递timer;
     */
    public function actionUser_report();
    /**
     * @name 累计粉丝总数（新增，取消关注等）
     * @sort 6
     * @date 2018-08-01
     * @post k:appid,v:wxxxxxxxxxx,t:授权公总号appid,n:
     * @post k:begin_date,v:2018-02-10,t:开始时间,n:
     * @post k:end_time,v:2018-05-06,t:结束时间,n:
     * @case {"wx_account_id#微信公众号id": "1cef072dbccb4f67c3bdf9b3627d8a0b","accountappid#公众号appid": "wxxxxxxxxxxxxx","new_user#新增的用户数量": "12","cancel_user#取消关注的用户数量": "11","clean_user#净增用户数量": "1","cumulate_user#总用户量": "965", "percent#增长率": {"new_user#新增的用户数量": {"yesterday#日": 0,"week#周": 1,"month#月": 0},"cancel_user#取消关注的用户数量": {"yesterday": 0,"week": 0.33,"month": 0},"clean_user#净增用户数量": {"yesterday": 0,"week": 0,"month": 0},"cumulate_user#总用户量": {"yesterday": 0,"week": 0,"month": 0}}}
     */
    public function actionUser_total();

    /**
     * @name 获取消息统计数据【用户发送】
     * @sort 7
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:type,v:1,t:消息类型（0全部 1代表文字 2代表图片 3代表语音 4代表视频 6代表第三方应用消息（链接消息）不传递此参数：默认全部）
     * @case {"wx_account_id#微信公众号id": "1cef072dbccb4f67c3bdf9b3627d8a0b","accountappid#公众号appid": "wxxxxxxxxxxxxx","msg_user#向公总号发送消息的用户数": "2","msg_count#向公众号发送发送的消息总数": "10"}
     * @remark <p style='color:red'>1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据。</p><p>2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。</p><p>3、为确保公众号数据已完成统计和处理，请于每天上午8点后查询公众号前一天的数据</p>
     */
    public function actionMessage_report();

    /**
     * @name 首页粉丝统计图
     * @sort 8
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @case {"wx_account_id#微信公总号id": "1cef072dbccb4f67c3bdf9b3627d8a0b","accountappid#微信公众号appid": "wxxxxxxxxxxxxxx","new_user#新增关注用户数": "12","cancel_user#取消关注用户数": "11","clean_user#净增用户数": "1","cumulate_user#累计用户总数": "965"}
     * @remark <p style='color:red'>1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据。</p><p>2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。</p><p>3、为确保公众号数据已完成统计和处理，请于每天上午8点后查询公众号前一天的数据</p>
     */
    //,"list#详细数据": {"yesterday#昨天【日】": {"new_user#新增关注用户数": "0","cancel_user#取消关注用户数": "0","clean_user#净增用户数": "0"},"nearly_a_week#周": {"new_user": "4","cancel_user": "1","clean_user": "3"},"nearly_a_month#月": {"new_user": "12","cancel_user": "11","clean_user": "1"}}
    public function actionUser_home_report();


    /**
     * @name 首页其他数据统计
     * @sort 9
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @case {"msg#消息": "1","article#文章": "4","template#模板": "0","material#素材": "31","total#文章统计":{"page_read_count#总阅读次数": "20","page_read_user#总阅读人数": "14","share_user#总分享人数": "0","share_count#总分享次数": "0","release_volume#总图文发布量": 6}}
     */
    public function actionUser_home_total();


}